PTCommandZPL Class Reference

Inherits from NSObject
Declared in PTCommandZPL.h

– generateCMDData

生成最终的指令数据(generate final command data)

- (NSData *)generateCMDData

Return Value

command data

Declared In

PTCommandZPL.h

– initCMDQueue

初始化指令队列。每次生成一组指令,都要初始化一次

- (void)initCMDQueue

Declared In

PTCommandZPL.h

– zplSetFont:fieldOrientation:characterHeight:width:

  • 设置缩放字体或点阵字体 set scalable font or bitmapped font *
  • @param fontName (A~Z),(0~9)
  • @param fieldOrientation (N,R,I,B)
  • @param characterHeight (10~32000)
  • @param width (10~32000)
- (void)zplSetFont:(NSString *)fontName fieldOrientation:(NSString *)fieldOrientation characterHeight:(NSInteger)characterHeight width:(NSInteger)width

Declared In

PTCommandZPL.h

– zplSetFontWithOrientation:height:width:location:fontName:extension:

^A@ 使用字体名调用字体。(The ^A@ command uses the complete name of a font, rather than the character designation used in ^A. Once a value for ^A@ is defined, it represents that font until a new font name is specified by ^A@.)

- (void)zplSetFontWithOrientation:(NSString *)orientation height:(NSInteger)height width:(NSInteger)width location:(NSString *)location fontName:(NSString *)fontName extension:(NSString *)extension

Parameters

orientation

(N,R,I,B) @param height @param width

location

(R, E, B, A) defualt:R @param extension

Discussion

@param fontName

Declared In

PTCommandZPL.h

– zplBacodeAztecWithOrientation:magnificationFactor:isContainECIC:errorAndSymbol:isMenuSymbol:appendSymbolNumber:appendOptionalID:

The ^B0 command creates a two-dimensional matrix symbology made up of square modules arranged around a bulls-eye pattern at the center.

- (void)zplBacodeAztecWithOrientation:(NSString *)orientation magnificationFactor:(NSInteger)magnificationFactor isContainECIC:(NSString *)isContainECIC errorAndSymbol:(NSInteger)errorAndSymbol isMenuSymbol:(NSString *)isMenuSymbol appendSymbolNumber:(NSInteger)appendSymbolNumber appendOptionalID:(NSString *)appendOptionalID

Parameters

orientation

(N,R,I,B)

magnificationFactor

(1~10)

isContainECIC

(Y,N),default is N

errorAndSymbol

(0),(01~99),(101~104),(201~232),(300)

isMenuSymbol

(Y,N),default is N

appendSymbolNumber

(1~26),default is 26

appendOptionalID

(<= 24 characters)

Declared In

PTCommandZPL.h

– zplBacodeCode11WithOrientation:checkDigit:barcodeHeight:interpretationLine:aboveCode:

^B1 Code 11条码(The ^B1 command produces the Code 11 bar code, also known as USD-8 code. In a Code 11 bar code, each character is composed of three bars and two spaces, and the character set includes 10 digits and the hyphen (-).)

- (void)zplBacodeCode11WithOrientation:(NSString *)orientation checkDigit:(NSString *)checkDigit barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

checkDigit

(Y,N)

barcodeHeight

(1~32000)

aboveCode

(Y,N) 注释行是否在条码上方

printInterpretationLine

(Y,N) 是否打印注释行

Declared In

PTCommandZPL.h

– zplBacodeCode39WithOrientation:checkDigit:barcodeHeight:interpretationLine:aboveCode:

^B3 Code 39 码。(The Code 39 bar code is the standard for many industries, including the U.S. Department of Defense. It is one of three symbologies identified in the American National Standards Institute (ANSI) standard MH10.8M-1983. Code 39 is also known as USD-3 Code and 3 of 9 Code.)

- (void)zplBacodeCode39WithOrientation:(NSString *)orientation checkDigit:(NSString *)checkDigit barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

checkDigit

(Y,N)

barcodeHeight

(1~32000)

aboveCode

(Y,N)

printInterpretationLine

(Y,N)

Declared In

PTCommandZPL.h

– zplBacodePlanetCodeWithOrientation:barcodeHeight:interpretationLine:aboveCode:

^B4 Code 49 码。

- (void)zplBacodePlanetCodeWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodePDF417CodeWithOrientation:barcodeHeight:securityLevel:columns:rows:truncation:

^B7 PDF417 码。(The ^B7 command produces the PDF417 bar code, a two-dimensional, multirow, continuous, stacked symbology. PDF417 is capable of encoding over 1,000 characters per bar code. It is ideally suited for applications requiring large amounts of information at the time the bar code is read.)

- (void)zplBarcodePDF417CodeWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight securityLevel:(NSInteger)securityLevel columns:(NSInteger)columns rows:(NSInteger)rows truncation:(NSString *)truncation

Parameters

orientation

(N, R, I, B)

barcodeHeight

(1 to height of label)

securityLevel

(1-8)

columns

(1-30)

rows

(3-90)

truncation

(N,Y)

Declared In

PTCommandZPL.h

– zplBacodeEAN8WithOrientation:barcodeHeight:interpretationLine:aboveCode:

^B8 EAN-8 条码。(The ^B8 command is the shortened version of the EAN-13 bar code. EAN is an acronym for European Article Numbering. Each character in the EAN-8 bar code is composed of four elements: two bars and two spaces.)

- (void)zplBacodeEAN8WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeUPCE8CodeWithOrientation:barcodeHeight:interpretationLine:aboveCode:checkDigit:

^B9 UPC-E 条码。(The ^B9 command produces a variation of the UPC symbology used for number system 0. It is a shortened version of the UPC-A bar code, where zeros are suppressed, resulting in codes that require less printing space. The 6 dot/mm, 12 dot/mm, and 24 dot/mm printheads produce the UPC and EAN symbologies at 100 percent of their size. However, an 8 dot/mm printhead produces the UPC and EAN symbologies at a magnification factor of 77 percent.)

- (void)zplBarcodeUPCE8CodeWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode checkDigit:(NSString *)checkDigit

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

checkDigit

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeCode93WithOrientation:barcodeHeight:interpretationLine:aboveCode:checkDigit:

^BA Code 93 条码。(The ^BA command creates a variable length, continuous symbology. The Code 93 bar code is used in many of the same applications as Code 39. It uses the full 128- character ASCII set. ZPL II, however, does not support ASCII control codes or escape sequences. It uses the substitute characters shown below.)

- (void)zplBarcodeCode93WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode checkDigit:(NSString *)checkDigit

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

checkDigit

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeCodeBlockWithOrientation:barcodeHeight:securityLevel:perRowCharacters:rows:mode:

^BB CodeBlock 条码。(The ^BB command produces a two-dimensional, multirow, stacked symbology. It is ideally suited for applications that require large amounts of information.)

- (void)zplBarcodeCodeBlockWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight securityLevel:(NSInteger)securityLevel perRowCharacters:(NSInteger)perRowCharacters rows:(NSInteger)rows mode:(NSString *)mode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

securityLevel

(Y,N)

perRowCharacters

(2-62 characters)

rows

(1-22)

mode

(A,E,F)

Declared In

PTCommandZPL.h

– zplBarcodeCode128WithOrientation:barcodeHeight:interpretationLine:aboveCode:checkDigit:mode:

^BC Code 128 条码。(The ^BC command creates the Code 128 bar code, a high-density, variable length, continuous, alphanumeric symbology. It was designed for complexly encoded product identification.)

- (void)zplBarcodeCode128WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode checkDigit:(NSString *)checkDigit mode:(NSString *)mode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

checkDigit

(Y,N)

mode

(N,U,A,D)

Declared In

PTCommandZPL.h

– zplBarcodeUPSMaxicodeWithMode:symbolNumber:totalSymbolNumbers:

^BD UPS Maxicode 条码。(The ^BD command creates a two-dimensional, optically read (not scanned) code. This symbology was developed by UPS (United Parcel Service).)

- (void)zplBarcodeUPSMaxicodeWithMode:(NSInteger)mode symbolNumber:(NSInteger)symbolNumber totalSymbolNumbers:(NSInteger)totalSymbolNumbers

Parameters

mode

(2-6) default:2

symbolNumber

(1-8) default:1

totalSymbolNumbers

(1-8) default:1

Declared In

PTCommandZPL.h

– zplBacodeEAN13WithOrientation:barcodeHeight:interpretationLine:aboveCode:

^BE EAN-18 条码。(The ^BE command is similar to the UPC-A bar code. It is widely used throughout Europe and Japan in the retail marketplace.)

- (void)zplBacodeEAN13WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeMicroPDF417WithOrientation:barcodeHeight:mode:

^BF 微型 PDF417 条码。(The ^BF command creates a two-dimensional, multi-row, continuous, stacked symbology identical to PDF417, except it replaces the 17-module-wide start and stop patterns and left/right row indicators with a unique set of 10-module-wide row address patterns. These reduce overall symbol width and allow linear scanning at row heights as low as 2X.)

- (void)zplBarcodeMicroPDF417WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight mode:(NSInteger)mode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

mode

(0~33)

Declared In

PTCommandZPL.h

– zplBacodeIndustrial2of5WithOrientation:barcodeHeight:interpretationLine:aboveCode:

^BI 工业二五码。(The ^BI command is a discrete, self-checking, continuous numeric symbology. The Industrial 2 of 5 bar code has been in use the longest of the 2 of 5 family of bar codes. Of that family, the Standard 2 of 5 (^BJ) and Interleaved 2 of 5 (^B2) bar codes are also available in ZPL II.)

- (void)zplBacodeIndustrial2of5WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBacodeStandard2of5WithOrientation:barcodeHeight:interpretationLine:aboveCode:

^BJ 标准二五码。(The ^BJ command is a discrete, self-checking, continuous numeric symbology.)

- (void)zplBacodeStandard2of5WithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeANSICodebarWithOrientation:checkDigit:barcodeHeight:interpretationLine:aboveCode:startCharacter:stopCharacter:

^BK ANSI Codebar条码。(The ANSI Codabar bar code is used in a variety of information processing applications such as libraries, the medical industry, and overnight package delivery companies. This bar code is also known as USD-4 code, NW-7, and 2 of 7 code. It was originally developed for retail price labeling.)

- (void)zplBarcodeANSICodebarWithOrientation:(NSString *)orientation checkDigit:(NSString *)checkDigit barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode startCharacter:(NSString *)startCharacter stopCharacter:(NSString *)stopCharacter

Parameters

orientation

(N,R,I,B)

checkDigit

(N)

barcodeHeight

(1-32000)

interpretationLine

(N,Y)

aboveCode

(N,Y)

startCharacter

(A,B,C,D)

stopCharacter

(A,B,C,D)

Declared In

PTCommandZPL.h

– zplBacodeLOGMARSWithOrientation:barcodeHeight:interpretationLine:aboveCode:

^BL LOGMARS 条码。(The ^BL command is a special application of Code 39 used by the Department of Defense. LOGMARS is an acronym for Logistics Applications of Automated Marking and Reading Symbols.)

- (void)zplBacodeLOGMARSWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeQRcodeWithOrientation:model:magnification:reliabilityLevel:

^BQ QRcode 二维码。(The ^BQ command produces a matrix symbology consisting of an array of nominally square modules arranged in an overall square pattern. A unique pattern at three of the symbol’s four corners assists in determining bar code size, position, and inclination.)

- (void)zplBarcodeQRcodeWithOrientation:(NSString *)orientation model:(NSInteger)model magnification:(NSInteger)magnification reliabilityLevel:(NSString *)reliabilityLevel

Parameters

orientation

(N,R,I,B)

model

(1,original),(2,enhanced)

magnification

(1-10)

reliabilityLevel

(H,Q,M,L)

Declared In

PTCommandZPL.h

– zplBacodeUPCEANExtensionsWithOrientation:barcodeHeight:interpretationLine:aboveCode:

The ^BS command is the two-digit and five-digit add-on used primarily by publishers to create bar codes for ISBNs (International Standard Book Numbers). These extensions are handled as separate bar codes.

- (void)zplBacodeUPCEANExtensionsWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeUPCAWithOrientation:barcodeHeight:interpretationLine:aboveCode:checkDigit:

^BU UPC-A 条码。(The ^BU command produces a fixed length, numeric symbology. It is primarily used in the retail industry for labeling packages. The UPC-A bar code has 11 data characters. The 6 dot/mm, 12 dot/mm, and 24 dot/mm printheads produce the UPC-A bar code (UPC/EAN symbologies) at 100 percent size. However, an 8 dot/mm printhead produces the UPC/EAN symbologies at a magnification factor of 77 percent.)

- (void)zplBarcodeUPCAWithOrientation:(NSString *)orientation barcodeHeight:(NSInteger)barcodeHeight interpretationLine:(NSString *)interpretationLine aboveCode:(NSString *)aboveCode checkDigit:(NSString *)checkDigit

Parameters

orientation

(N,R,I,B)

barcodeHeight

(1~32000)

interpretationLine

(Y,N)

aboveCode

(Y,N)

checkDigit

(Y,N)

Declared In

PTCommandZPL.h

– zplBarcodeFieldDefaultWithModuleWidth:ratio:barcodeHeight:

The ^BY command is used to change the default values for the module width (in dots), the wide bar to narrow bar width ratio and the bar code height (in dots). It can be used as often as necessary within a label format.

- (void)zplBarcodeFieldDefaultWithModuleWidth:(NSInteger)moduleWidth ratio:(CGFloat)ratio barcodeHeight:(NSInteger)barcodeHeight

Parameters

moduleWidth

(1-10)

ratio

(2.0-3.0) default:3.0

barcodeHeight

(10)

Declared In

PTCommandZPL.h

– zplChangeCaret:

  • 改变格式指令前缀。缺省前缀是脱字符。 (The ^CC command is used to change the format command prefix. The default prefix is the caret (^).) *
  • @param charactor (any ASCII character)
- (void)zplChangeCaret:(NSString *)charactor

Declared In

PTCommandZPL.h

– zplChangeDelimiter:

改变 ZPL 分隔符,缺省分隔符是‘,’。(The ^CD and ~CD commands are used to change the delimiter character. This character is used to separate parameter values associated with several ZPL II commands. The default delimiter is a comma (,))

- (void)zplChangeDelimiter:(NSString *)charactor

Parameters

charactor

(any ASCII character)

Declared In

PTCommandZPL.h

– zplChangeDefaultFont:width:height:

改变默认字体。(The ^CF command sets the default font used in your printer. You can use the ZPL Commands ^CF command to simplify your programs.)

- (void)zplChangeDefaultFont:(NSString *)font width:(NSInteger)width height:(NSInteger)height

Parameters

font

(A-Z),(0~9)

width

(0~32000) 不设置宽度:-1

height

(0~32000) 不设置宽度:-1

Declared In

PTCommandZPL.h

– zplChangeInternationalCharacterSet:parameter:

改变国际字体、编码。(international character sets: U.S.A.1, U.S.A.2, UK, Holland, Denmark/Norway, Sweden/Finland, Germany, France 1, France 2, Italy, Spain, and several other sets, including the Unicode character set.)

- (void)zplChangeInternationalCharacterSet:(NSString *)characterSet parameter:(NSString *)parameter

Parameters

characterSet

(0-36)

parameter

(0-255,多个参数以',‘分隔)

Declared In

PTCommandZPL.h

– zplCodeValidation:

The ^CV command acts as a switch to turn the code validation function on and off. When this command is turned on, all bar code data is checked for these error conditions:

- (void)zplCodeValidation:(NSString *)codeValidation

Parameters

codeValidation

(Y,N)

Declared In

PTCommandZPL.h

– zplFontIdentifier:fontDriveLocation:downloadedFont:extension:

字体标识。All built-in fonts are referenced using a one-character identifier. The ^CW command assigns a single alphanumeric character to a font stored in DRAM, memory card, EPROM, or Flash.

- (void)zplFontIdentifier:(NSString *)fontName fontDriveLocation:(NSString *)fontDriveLocation downloadedFont:(NSString *)downloadedFont extension:(NSString *)extension

Parameters

fontName

(A~Z),(0~9)

fontDriveLocation

(R, E, B, A)

downloadedFont

(<= 8 characters)

extension

(FNT,TTF,TTE)

Declared In

PTCommandZPL.h

– zplDownloadFormatWithDevice:imageName:extension:

下载格式。The ^DF command saves ZPL II format commands as text strings to be later merged using ^XF with variable data. The format to be stored might contain field number (^FN) commands to be referenced when recalled.

- (void)zplDownloadFormatWithDevice:(NSString *)deviceToStoreImage imageName:(NSString *)imageName extension:(NSString *)extension

Parameters

deviceToStoreImage

(R, E, B, A)

imageName

(1 to 8 alphanumeric characters)

extension

(.ZPL)

Declared In

PTCommandZPL.h

– zplDownloadGraphicsWithStoreDevice:imageName:extension:imageWidth:imageData:

下载图像。The ~DG command downloads an ASCII Hex representation of a graphic image. If .GRF is not the specified file extension, .GRF is automatically appended.

- (void)zplDownloadGraphicsWithStoreDevice:(NSString *)storeDevice imageName:(NSString *)imageName extension:(NSString *)extension imageWidth:(NSInteger)imageWidth imageData:(NSData *)imageData

Parameters

storeDevice

(R, E, B, A)

imageName

(1 to 8 alphanumeric characters)

extension

(.GRF) @param imageData

Declared In

PTCommandZPL.h

– zplEraseDownloadGraphics

从 DRRAM 中删除所有图像

- (void)zplEraseDownloadGraphics

Declared In

PTCommandZPL.h

– zplFieldData:

字段数据,使用“&” 回车换行,使用“()”作为软连字符(单词断开时使用),当连字符在一行的最后,会被打印出来,()表示任意的数字或字母

- (void)zplFieldData:(NSString *)fieldData

Parameters

fieldData

(up to 3072 bytes)

Declared In

PTCommandZPL.h

– zplFieldHexadecimalIndicator:

字段的十六进制表示。The ^FH command allows you to enter the hexadecimal value for any character directly into the ^FD statement. The ^FH command must precede each ^FD command that uses hexadecimals in its field.

- (void)zplFieldHexadecimalIndicator:(NSString *)hexadecimalIndicator

Parameters

hexadecimalIndicator

(any character except current format and control prefix (^ and ~ by default))

Declared In

PTCommandZPL.h

– zplFieldNumber:optional:

字段编号指令。

- (void)zplFieldNumber:(NSInteger)fieldNumber optional:(NSString *)optional

Parameters

fieldNumber

字段编号

optional

(0-9999), default 1

Declared In

PTCommandZPL.h

– zplFieldOriginWithXAxis:YAxis:justification:

字段位置。The ^FO command sets a field origin, relative to the label home (^LH) position. ^FO sets the upper-left corner of the field area by defining points along the x-axis and y-axis independent of the rotation.

- (void)zplFieldOriginWithXAxis:(NSInteger)XAxis YAxis:(NSInteger)YAxis justification:(NSInteger)justification

Parameters

XAxis

(0~32000)

YAxis

(0~32000)

justification

(0,1,2),当不设置对齐项时,传入-1

Declared In

PTCommandZPL.h

– zplFieldParameterWithDirection:characterGap:

字段参数。The ^FP command allows vertical and reverse formatting of the font field, commonly used for printing Asian fonts.

- (void)zplFieldParameterWithDirection:(NSString *)direction characterGap:(NSInteger)characterGap

Parameters

direction

(H,left to right),(V,top to bottom),(R, reverse printing), default is H

characterGap

(0~9999)

Declared In

PTCommandZPL.h

– zplFieldReversePrint

字段反相打印

- (void)zplFieldReversePrint

Declared In

PTCommandZPL.h

– zplFieldSeparator

字段分隔

- (void)zplFieldSeparator

Declared In

PTCommandZPL.h

– zplFieldTypesetWithXAxis:YAxis:justification:

字段排版。The ^FT command sets the field position, relative to the home position of the label designated by the ^LH command. The typesetting origin of the field is fixed with respect to the contents of the field and does not change with rotation.

- (void)zplFieldTypesetWithXAxis:(NSInteger)XAxis YAxis:(NSInteger)YAxis justification:(NSInteger)justification

Parameters

XAxis

(0~32000)

YAxis

(0~32000)

justification

(0,1,2)

Declared In

PTCommandZPL.h

– zplFieldVariable:

可改变数据段。FV replaces the ^FD (field data) command in a label format when the field is variable.

- (void)zplFieldVariable:(NSString *)variableFieldData

Parameters

variableFieldData

(0~3072 byte string)

Declared In

PTCommandZPL.h

– zplFieldOrientation:justification:

The ^FW command sets the default orientation for all command fields that have an orientation (rotation) parameter (and in x.14 sets the default justification for all commands with a justification parameter). Fields can be rotated 0, 90, 180, or 270 degrees clockwise by using this command. In x.14, justification can be left, right, or auto.

- (void)zplFieldOrientation:(NSString *)fieldOrientation justification:(NSInteger)justification

Parameters

fieldOrientation

(N, R, I, B)

justification

(0,1,2)

Declared In

PTCommandZPL.h

– zplFieldComment:

字段注释。The ^FX command is useful when you want to add non-printing informational comments or statements within a label format. Any data after the ^FX command up to the next caret (^) or tilde (~) command does not have any effect on the label format. Therefore, you should avoid using the caret (^) or tilde (~) commands within the ^FX statement.

- (void)zplFieldComment:(NSString *)comment

Parameters

comment

注释字符

Declared In

PTCommandZPL.h

– zplGraphicBoxWithWidth:height:thickness:lineColor:cornorRoundingDegree:

打印矩形。The ^GB command is used to draw boxes and lines as part of a label format. Boxes and lines are used to highlight important information, divide labels into distinct areas, or to improve the appearance of a label. The same format command is used for drawing either boxes or lines.

- (void)zplGraphicBoxWithWidth:(NSInteger)width height:(NSInteger)height thickness:(NSInteger)thickness lineColor:(NSString *)lineColor cornorRoundingDegree:(NSInteger)cornorRoundingDegree

Parameters

width

(thickness~32000)

height

(thickness~32000)

thickness

(1~32000)

lineColor

(B,black),(W,white) default:B

cornerDegree

(0~8) default:0

Declared In

PTCommandZPL.h

– zplGraphicCircleWithDiameter:thickness:lineColor:

打印圆形。The ^GC command produces a circle on the printed label. The command parameters specify the diameter (width) of the circle, outline thickness, and color. Thickness extends inward from the outline.

- (void)zplGraphicCircleWithDiameter:(NSInteger)diameter thickness:(NSInteger)thickness lineColor:(NSString *)lineColor

Parameters

diameter

(3~4095) default:3

thickness

(2~4095) default:1

lineColor

(B,W),black,white default:B

Declared In

PTCommandZPL.h

– zplGraphicDiagonalLineWithWidth:height:thickness:lineColor:orientation:

The ^GD command produces a straight diagonal line on a label. This can be ZPL Commands Parameters used in conjunction with other graphic commands to create a more complex figure.

- (void)zplGraphicDiagonalLineWithWidth:(NSInteger)width height:(NSInteger)height thickness:(NSInteger)thickness lineColor:(NSString *)lineColor orientation:(NSString *)orientation

Parameters

width

(thickness~32000)

height

(thickness~32000)

thickness

(1~32000)

lineColor

(B,black),(W,white)

orientation

(R,L)

Declared In

PTCommandZPL.h

– zplGraphicEllipseWithWidth:height:thickness:lineColor:

The ^GE command produces an ellipse in the label format.

- (void)zplGraphicEllipseWithWidth:(NSInteger)width height:(NSInteger)height thickness:(NSInteger)thickness lineColor:(NSString *)lineColor

Parameters

width

(3~4095)

height

(3~4095)

thickness

(2~4095)

lineColor

(B,black),(W,white)

Declared In

PTCommandZPL.h

– zplGraphicSymbolWithOrientation:height:width:

The ^GS command enables you to generate the registered trademark, copyright symbol, and other symbols.

- (void)zplGraphicSymbolWithOrientation:(NSString *)orientation height:(NSInteger)height width:(NSInteger)width

Parameters

orientation

(N,R,I,B)

height

(0-32000)

width

(0-32000)

Declared In

PTCommandZPL.h

– zplImageDeleteWithObjectLocation:objectName:extension:

The ^ID command deletes objects, graphics, fonts, and stored formats from storage areas. Objects can be deleted selectively or in groups. This command can be used within a printing format to delete objects before saving new ones, or in a stand-alone format to delete objects.

- (void)zplImageDeleteWithObjectLocation:(NSString *)objectLocation objectName:(NSString *)objectName extension:(NSString *)extension

Parameters

objectLocation

(R, E, B, A)

objectName

(any 1 to 8 character name)

extension

(.GRF)

Declared In

PTCommandZPL.h

– zplImageLoadWithObjectLocation:objectName:extension:

The ^IL command is used at the beginning of a label format to load a stored image of a format and merge it with additional data. The image is always positioned at ^FO0,0.

- (void)zplImageLoadWithObjectLocation:(NSString *)objectLocation objectName:(NSString *)objectName extension:(NSString *)extension

Parameters

objectLocation

(R, E, B, A)

objectName

(1 to 8 alphanumeric characters)

extension

(.GRF, .PNG)

Declared In

PTCommandZPL.h

– zplImageMoveWithObjectLocation:objectName:extension:

The ^IM command performs a direct move of an image from storage area into the bitmap. The command is identical to the ^XG command (Recall Graphic), except there are no sizing parameters.

- (void)zplImageMoveWithObjectLocation:(NSString *)objectLocation objectName:(NSString *)objectName extension:(NSString *)extension

Parameters

objectLocation

(R, E, B, A)

objectName

(1 to 8 alphanumeric characters)

extension

(.GRF, .PNG)

Declared In

PTCommandZPL.h

– zplImageSaveWithObjectLocation:objectName:extension:printAfterSorting:

The ^IS command is used within a label format to save that format as a graphic image, rather than as a ZPL II script. It is typically used toward the end of a script. The saved image can later be recalled with virtually no formatting time and overlaid with variable data to form a complete label.

- (void)zplImageSaveWithObjectLocation:(NSString *)objectLocation objectName:(NSString *)objectName extension:(NSString *)extension printAfterSorting:(NSString *)printAfterSorting

Parameters

objectLocation

(R, E, B, A)

objectName

(1 to 8 alphanumeric characters)

extension

(.GRF, .PNG)

printAfterSorting

(Y,N)

Declared In

PTCommandZPL.h

– zplSetReprintAfterError:

(Y/N)

- (void)zplSetReprintAfterError:(NSString *)enable

Parameters

enable

(Y/N)

Declared In

PTCommandZPL.h

– zplLabelHomeWithXPos:YPos:

(0~32000)

- (void)zplLabelHomeWithXPos:(NSInteger)XPos YPos:(NSInteger)YPos

Parameters

x_pos

(0~32000)

y_pos

(0~32000)

Declared In

PTCommandZPL.h

– zplLabelReversePrint:

The ^LR command reverses the printing of all fields in the label format. It allows a field to appear as white over black or black over white.

- (void)zplLabelReversePrint:(NSString *)reverse

Parameters

reverse

(Y,N)

Declared In

PTCommandZPL.h

– zplLabelShift:

(-9999~9999)

- (void)zplLabelShift:(NSInteger)shift

Parameters

shift

(-9999~9999)

Declared In

PTCommandZPL.h

– zplLabelTop:

The ^LT command moves the entire label format a maximum of 120 dot rows up or down from its current position, in relation to the top edge of the label. A negative value moves the format towards the top of the label; a positive value moves the format away from the top of the label.

- (void)zplLabelTop:(NSInteger)top

Parameters

top

(-120~120)

Declared In

PTCommandZPL.h

– zplMapClear:

In normal operation, the bitmap is cleared after the format has been printed. The ^MC command is used to retain the current bitmap. This applies to current and subsequent labels until cleared with ^MCY.

- (void)zplMapClear:(NSString *)clear

Parameters

clear

(Y,N)

Declared In

PTCommandZPL.h

– zplMaximumLabelLength:

The ^ML command lets you adjust the maximum label length

- (void)zplMaximumLabelLength:(NSInteger)length

Parameters

length

0 to maximum length of label

Declared In

PTCommandZPL.h

– zplMediaType:

The ^MT command selects the type of media being used in the printer. These are the choices for this command:

- (void)zplMediaType:(NSString *)type

Parameters

type

(T = thermal transfer media),(D = direct thermal media)

Declared In

PTCommandZPL.h

– zplSetMediaType:

(T/D)

- (void)zplSetMediaType:(NSString *)type

Parameters

type

(T/D)

Declared In

PTCommandZPL.h

– zplPrintLabelMirrorImage:

The ^PM command prints the entire printable area of the label as a mirror image. This command flips the image from left to right.

- (void)zplPrintLabelMirrorImage:(NSString *)mirror

Parameters

mirror

(Y,N)

Declared In

PTCommandZPL.h

– zplPrintOrientation:

The ^PO command inverts the label format 180 degrees. The label appears to be printed upside down. If the original label contains commands such as ^LL, ^LS, ^LT and ^PF, the inverted label output is affected differently.

- (void)zplPrintOrientation:(NSString *)orientation

Parameters

orientation

(N,I),normal,invert

Declared In

PTCommandZPL.h

– zplPrintQuantity:pauseValue:replicateValue:overrided:

The ^PQ command gives control over several printing operations. It controls the number of labels to print, the number of labels printed before printer pauses, and the number of replications of each serial number.

- (void)zplPrintQuantity:(NSInteger)quantity pauseValue:(NSInteger)pauseValue replicateValue:(NSInteger)replicateValue overrided:(NSString *)overrided

Parameters

quantity

(1-99 999 999)

pauseValue

(1-99 999 999)

replicateValue

(0-99 999 999)

overrided

(N,Y)

Declared In

PTCommandZPL.h

– zplPrintWidth:

(0~864)

- (void)zplPrintWidth:(NSInteger)width

Parameters

width

(0~864)

Declared In

PTCommandZPL.h

– zplSetDarkness:

The ~SD command allows you to set the darkness of printing. ~SD is the equivalent of the darkness setting parameter on the control panel display.

- (void)zplSetDarkness:(NSInteger)darkness

Parameters

darkness

(0~30)

Declared In

PTCommandZPL.h

– zplSerializationFieldWithMaskString:incrementString:

The ^SF command allows you to serialize a standard ^FD string. The maximum size of the mask and increment string is 3K combined.

- (void)zplSerializationFieldWithMaskString:(NSString *)maskString incrementString:(NSString *)incrementString

Parameters

maskString

(D,H,O,A,N)

incrementString

()

Declared In

PTCommandZPL.h

– zplTransferObjectWithSourceDevice:sourceObjectName:sourceExtension:destinationDevice:destinationObjectName:destinationExtension:

The ^TO command is used to copy an object or group of objects from one storage device to another. It is similar to the copy function used in PCs.

- (void)zplTransferObjectWithSourceDevice:(NSString *)sourceDevice sourceObjectName:(NSString *)sourceObjectName sourceExtension:(NSString *)sourceExtension destinationDevice:(NSString *)destinationDevice destinationObjectName:(NSString *)destinationObjectName destinationExtension:(NSString *)destinationExtension

Parameters

sourceDevice

(R, E, B, A) @param sourceObjectName @param sourceExtension

destinationDevice

(R, E, B, A) @param destinationObjectName @param destinationExtension

Declared In

PTCommandZPL.h

– zplRecallFormatWithSourceDevice:imageName:extension:

The ^XF command recalls a stored format to be merged with variable data. There can be multiple ^XF commands in one format, and they can be located anywhere within the code.

- (void)zplRecallFormatWithSourceDevice:(NSString *)sourceDevice imageName:(NSString *)imageName extension:(NSString *)extension

Parameters

sourceDevice

(R, E, B, A)

imageName

1 to 8 alphanumeric characters

extension

(.ZPL)

Declared In

PTCommandZPL.h

– zplRecallGraphicWithSourceDevice:imageName:extension:XAxisMagnification:YAxisMagnification:

The ^XG command is used to recall one or more graphic images for printing. This command is used in a label format to merge graphics, such as company logos and piece parts, with text data to form a complete label.

- (void)zplRecallGraphicWithSourceDevice:(NSString *)sourceDevice imageName:(NSString *)imageName extension:(NSString *)extension XAxisMagnification:(NSInteger)XAxisMagnification YAxisMagnification:(NSInteger)YAxisMagnification

Parameters

sourceDevice

(R, E, B, A)

imageName

1 to 8 alphanumeric characters

extension

(.GRF)

XAxisMagnification

(1~10)

YAxisMagnification

(1~10)

Declared In

PTCommandZPL.h